﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html>
    <head>
        <meta content="Innovasys Document! X (http://www.innovasys.com)" name=GENERATOR>
        <!--DXMETADATA start type="MetaCharset" --><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8"><!--DXMETADATA end-->
        <!--DXMETADATA start type="PageItemTitle" format="<title>SetMask Method (XtremePropertyGrid)</title>" --><title>SetMask Method</title><!--DXMETADATA end-->
        <link href="stylesheets/axstylesheet.css" type=text/css rel=stylesheet>
        <script src="script/ax.js" type=text/javascript>
    </script>

    


<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
    <body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(12881);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../index.htm?page=XtremePropertyGrid~PropertyGridItemDouble~SetMask.html";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="XtremePropertyGrid~PropertyGridItemColor~SetMask.html" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="template2/btn_prev_n.gif" border="0"></a><A href="XtremePropertyGrid~PropertyGridItemPicture~SetMask.html" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="welcome_screen.htm">Codejock ActiveX Controls v15.3</A> &gt; <A href="XtremePropertyGrid_P.html">Xtreme Property Grid</A> &gt; Methods &gt; </div>
	<div id="winchm_template_title">SetMask Method (XtremePropertyGrid)</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div class=popupbubble id=dxseealsomenu><p id=dxseealsocontent><a href="#Bookmark12472">PropertyGridItemDouble Object</a>
</p><!--DXMETADATA end --> 
        </div>
        <!--DXMETADATA start type="FilteredItemList" scrap="PARAMETERS_BUBBLES" namespace="parameter" source="Item" -->
<div id="Mask_box" class="popupbubble">
<DL><DT class="popupbubble"><I>Mask</I></DT>
<DD class="popupbubble"><P><FONT face=Verdana size=2>You can use any of these characters for defining your edit mask:</FONT></P>
<P><FONT face="Courier New" size=2><FONT color=#0000ff>0</FONT> - Numeric (0-9)<BR><FONT color=#0000ff>9</FONT> - Numeric (0-9) or space (' ')<BR><FONT color=#0000ff>#</FONT> - Numeric (0-9) or space (' ') or ('+') or ('-')<BR><FONT color=#0000ff>L</FONT> - Alpha (a-Z)<BR><FONT color=#0000ff>?</FONT> - Alpha (a-Z) or space (' ')<BR><FONT color=#0000ff>A</FONT> - Alpha numeric (0-9 and a-Z)<BR><FONT color=#0000ff>a</FONT> - Alpha numeric (0-9 and a-Z) or space (' ')<BR><FONT color=#0000ff>&amp;</FONT> - All print character only<BR><FONT color=#0000ff>H</FONT> - Hex digit (0-9 and A-F)<BR><FONT color=#0000ff>X</FONT> - Hex digit (0-9 and A-F) and space (' ')<BR><FONT color=#0000ff>&gt;</FONT> - Forces characters to upper case (A-Z)<BR><FONT color=#0000ff>&lt;</FONT> - Forces characters to lower case (a-z)</FONT></P>
<P>&nbsp;</P>
<P><FONT face=Verdana size=2>Any of these characters can be combined with additional characters to create a restrictive field for text entry.&nbsp; For example, if you wanted to display a prompt for a telephone number and wanted to restrict only numeric values, but wanted to display the area code inside of parentheses '(' and ')' then you could define your mask as:</FONT></P>
<P>&nbsp;</P>
<P><FONT face="Courier New" size=2>Phone No: (<FONT color=#0000ff>000</FONT>) <FONT color=#0000ff>000</FONT>-<FONT color=#0000ff>0000</FONT></FONT></P></DD></DL>
</div>
<div id="Literal_box" class="popupbubble">
<DL><DT class="popupbubble"><I>Literal</I></DT>
<DD class="popupbubble"><P>&nbsp;<FONT face=Verdana><FONT size=2>Literal defines the prompt area of the mask where text entry is allowed.&nbsp; This should match the areas that you have already defined as mask fields.&nbsp; By default the prompt character is '_' .</FONT></FONT></P>
<P>&nbsp;</P>
<P><FONT face="Courier New" size=2>Phone No: (<FONT color=#0000ff>___</FONT>) <FONT color=#0000ff>___</FONT>-<FONT color=#0000ff>____</FONT></FONT></P></DD></DL>
</div>
<div id="Prompt_box" class="popupbubble">
<DL><DT class="popupbubble"><I>Prompt</I></DT>
<DD class="popupbubble"><P><FONT face=Verdana size=2>This value is optional, but allows you to define default characters that you want displayed when the user presses the backspace key.&nbsp; This usually represents data that has been previously saved then restored.&nbsp; This makes it easy for the user to restore some or all of the default text displayed when the control was initialized.&nbsp;&nbsp;Again, this value should match the previously defined mask:</FONT></P>
<P>&nbsp;</P>
<P><FONT face="Courier New" size=2>Phone No: (<FONT color=#0000ff>800</FONT>) <FONT color=#0000ff>555</FONT>-<FONT color=#0000ff>1212</FONT></FONT></P></DD></DL>
</div>
<!--DXMETADATA end --> 
        <div id=pagetop>
            <div id=projectnamebanner>
                <table class=projectnametable cellspacing=0>
                    <tbody>
                        <tr>
                            <!--DXMETADATA start type="Literal" condition="childitems:itemtype=seealso" value="<td class='button'><a href='' id='seealsobutton' onclick='showSeeAlsoBox()'><img alt='See Also' border='0' src='axImages/seealso.gif' width=14 height=14></a></td>" --><td class='button'><a href='' id='seealsobutton' onclick='showSeeAlsoBox()'><img alt='See Also' border='0' src='axImages/seealso.gif' width=14 height=14></a></td><!--DXMETADATA end -->
                            <td>
                                <!--DXMETADATA start type="Phrase" Name="Product_Header" -->Xtreme Property Grid ActiveX Control v15.3<!--DXMETADATA end --> 
                            </td>
                            <td align=right>
                                <!--DXMETADATA start type="Variable" name="FeedbackLink" format="" --><!--DXMETADATA end -->
                            </td>
                        </tr>
                    </tbody>
                </table>
            </div>
            <div id=pagetitlebanner>
                <h1 class=dxh1>
                <!--DXMETADATA start type="PageItemTitle" -->SetMask Method<!--DXMETADATA end --></h1>
            </div>
        </div>
        <div id=pagebody valign="bottom">
            <!--DXMETADATA start type="IsNew" format="<script>document.all.pagebody.className = 'newTopic'</script>" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="Description" source="Item" format="<h4 class=dxh4>$$Description$$</h4><p>%%description%%</p>" --><h4 class=dxh4>Description</h4><p><p>Applies&nbsp;the specified&nbsp;Mask to a PropertyGridItem data field.</p></p><!--DXMETADATA end --> 
            <!--DXMETADATA start type="Syntax" lang="VB" format="<div Class=LanguageSpecific Name=Syntax_VB><h4 class=dxh4>$$Syntax$$</h4><p>%%Syntax%%</p></div>" --><div Class=LanguageSpecific Name=Syntax_VB><h4 class=dxh4>Syntax</h4><p><PRE CLASS="syntax" LANG="VB"><strong>Public Sub SetMask</strong>( _
&nbsp;&nbsp;&nbsp;<strong>ByVal </strong><i><a class="parameter" id="Mask" href="#" onclick="javascript:showParamBox();">Mask</a></i></strong> <strong>As</strong> <b>String</b>, _
&nbsp;&nbsp;&nbsp;<strong>ByVal </strong><i><a class="parameter" id="Literal" href="#" onclick="javascript:showParamBox();">Literal</a></i></strong> <strong>As</strong> <b>String</b>, _
&nbsp;&nbsp;&nbsp;<strong>Optional ByVal </strong><i><a class="parameter" id="Prompt" href="#" onclick="javascript:showParamBox();">Prompt</a></i></strong> <strong>As</strong> <b>Variant</b> _
)<strong> </strong></PRE></p></div><!--DXMETADATA end --> 
            <!--DXMETADATA start type="FilteredItemList" scrap="PARAMETERS_LIST" namespace="parameter" source="Item" filter="" format="<h4 class=dxh4>$$ParameterList$$</h4>%%filtereditemlist%%" --><h4 class=dxh4>Parameters</h4><DL>
<DT><I>Mask</I></DT>
<DD><P><FONT face=Verdana size=2>You can use any of these characters for defining your edit mask:</FONT></P>
<P><FONT face="Courier New" size=2><FONT color=#0000ff>0</FONT> - Numeric (0-9)<BR><FONT color=#0000ff>9</FONT> - Numeric (0-9) or space (' ')<BR><FONT color=#0000ff>#</FONT> - Numeric (0-9) or space (' ') or ('+') or ('-')<BR><FONT color=#0000ff>L</FONT> - Alpha (a-Z)<BR><FONT color=#0000ff>?</FONT> - Alpha (a-Z) or space (' ')<BR><FONT color=#0000ff>A</FONT> - Alpha numeric (0-9 and a-Z)<BR><FONT color=#0000ff>a</FONT> - Alpha numeric (0-9 and a-Z) or space (' ')<BR><FONT color=#0000ff>&amp;</FONT> - All print character only<BR><FONT color=#0000ff>H</FONT> - Hex digit (0-9 and A-F)<BR><FONT color=#0000ff>X</FONT> - Hex digit (0-9 and A-F) and space (' ')<BR><FONT color=#0000ff>&gt;</FONT> - Forces characters to upper case (A-Z)<BR><FONT color=#0000ff>&lt;</FONT> - Forces characters to lower case (a-z)</FONT></P>
<P>&nbsp;</P>
<P><FONT face=Verdana size=2>Any of these characters can be combined with additional characters to create a restrictive field for text entry.&nbsp; For example, if you wanted to display a prompt for a telephone number and wanted to restrict only numeric values, but wanted to display the area code inside of parentheses '(' and ')' then you could define your mask as:</FONT></P>
<P>&nbsp;</P>
<P><FONT face="Courier New" size=2>Phone No: (<FONT color=#0000ff>000</FONT>) <FONT color=#0000ff>000</FONT>-<FONT color=#0000ff>0000</FONT></FONT></P></DD>
<DT><I>Literal</I></DT>
<DD><P>&nbsp;<FONT face=Verdana><FONT size=2>Literal defines the prompt area of the mask where text entry is allowed.&nbsp; This should match the areas that you have already defined as mask fields.&nbsp; By default the prompt character is '_' .</FONT></FONT></P>
<P>&nbsp;</P>
<P><FONT face="Courier New" size=2>Phone No: (<FONT color=#0000ff>___</FONT>) <FONT color=#0000ff>___</FONT>-<FONT color=#0000ff>____</FONT></FONT></P></DD>
<DT><I>Prompt</I></DT>
<DD><P><FONT face=Verdana size=2>This value is optional, but allows you to define default characters that you want displayed when the user presses the backspace key.&nbsp; This usually represents data that has been previously saved then restored.&nbsp; This makes it easy for the user to restore some or all of the default text displayed when the control was initialized.&nbsp;&nbsp;Again, this value should match the previously defined mask:</FONT></P>
<P>&nbsp;</P>
<P><FONT face="Courier New" size=2>Phone No: (<FONT color=#0000ff>800</FONT>) <FONT color=#0000ff>555</FONT>-<FONT color=#0000ff>1212</FONT></FONT></P></DD>
</DL><!--DXMETADATA end --> 
            <!--DXMETADATA start type="TaggedComment" source="Item" id="##RETURNS" format="<h4 class=dxh4>$$Return_Type$$</h4><p>%%comment%%</p>" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="TaggedComment" source="Item" id="##REMARKS" format="<h4 class=dxh4>$$Remarks$$</h4><p>%%comment%%</p>" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="sourcecode" format="<h4 class=dxh4>$$Source_Code$$</h4><table border=0 cellpadding=0 cellspacing=0 class=sourcecode><tr><td nowrap>%%sourcecode%%</td></tr></table>" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="TaggedComment" source="Item" id="##EXAMPLEINTRO" format="<h4 class=dxh4>$$Example$$</h4><p>%%comment%%</p>" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="FilteredItemList" scrap="INLINE_EXAMPLE" namespace="Example" source="Item" filter="type=inline" NoHeader="True" NoFooter="True" format="<h4 class=dxh4>$$Example$$</h4>,format= %%%%filtereditemlist%%" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="FilteredItemList" scrap="MENU_LINK" namespace="seealso" source="Item" filter="" NoHeader="True" NoFooter="True" format="<h4 class=dxh4>$$See_Also$$</h4><p id=dxseealsocontent>%%filtereditemlist%%</p>" --><h4 class=dxh4>See Also</h4><p id=dxseealsocontent><a href="#Bookmark12472">PropertyGridItemDouble Object</a>
</p><!--DXMETADATA end --><!--DXMETADATA start type="FilteredItemList" scrap="MENU_LINK" namespace="example" source="Item" filter="type=linked" NoHeader="True" NoFooter="True" format="><!--DXMETADATA end --><!--DXMETADATA start type="Variable" name="CopyrightNotice" format="><!--DXMETADATA end --></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2018. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>

